.TH E1432_SET_AMP_SCALE 3 E1432
.SH NAME
.nf
e1432_set_amp_scale \- Set source amplitude scale of E1432 channels
e1432_get_amp_scale \- Get current source amplitude scale of E1432 channels
.fi
.IX e1432_set_amp_scale(3) 3
.IX e1432_get_amp_scale(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_amp_scale(E1432ID hw, SHORTSIZ16 ID,
                               FLOATSIZ32 amp_scale)
SHORTSIZ16 e1432_get_amp_scale(E1432ID hw, SHORTSIZ16 ID,
                               FLOATSIZ32 *amp_scale)
.cE
.SH DESCRIPTION

\fIe1432_set_amp_scale\fR sets the source amplitude scale factor, of a
single channel or group of channels \fIID\fR, to the value given in
\fIamp_scale\fR.

\fIe1432_get_amp_scale\fR returns the current value of the source
amplitude scale factor, of a single channel or group of channels
\fIID\fR, into a memory location pointed to by \fIamp_scale\fR.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.

\fIamp_scale\fR is the amplitude scale factor, which must be between
zero and one.

For input channels, amplitude scale is not used.

For source channels, the actual source amplitude generated is equal to
the full-scale range (set by e1432_set_range) multiplied by the
amplitude scale factor.  The \fIrange\fR specifies an overall maximum
signal level (typically on a range DAC reserved for this purpose)
which can't be changed instantaneously during output.  The
\fIamplitude scale factor\fR has finer resolution and can be adjusted
instantaneously during output.

For tach channels, neither range nor amplitude scale are used.
.SH "RESET VALUE"
After a reset, the source \fIamp_scale\fR is set to one.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_range, e1432_get_amp_scale_limits
.ad
